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EDITOR : Gordon Bentzen 

HELPERS i Bob Devries and Don Berrie 

SUPPORT : Brisbane 0S9 Level 2 User Group. 

Welcome to the October Edition of the Australian 0S9 Newsletter. 

One of the problems in presenting the Newsletter each month is trying to present sufficient uorthuhile material to 
maintain your interest^ while keeping the broad spectrum of readers happy. It's plain to see that while articles 
about the kerneh sysgo or init modules* or programmes involving complex 'C functions might be interesting to 
soiTfe, they would be complete double-dutch to others. With that in nind, one of the things which came to mind 
recently* was the possibility of developing a 'wish list" of things for 0S9. This could be hardware* software or 
simply documentation. Let's see if we can't start the ball rolling. 

A. Hardware : Anything to do with Hard Disks, What about a battery backed ramdisk. No-halt floppy controllers. 
How about a way to tidy up the CoCo Multi-Pak, ROMPak Cartridge problem. An extension keyboard. Battery backed 
system clock. 

B. Software : What about a graphics terminal driver. MIDI support for OSK/68BB0. A screen blanking utility a la 
MACINTOSH, A high speed terminal program. An intelligent compiler environment prograinme. User friendly 
installation programmes for existing software. 

C. Documentation ; User friendly documentation for system calls. Decent documentation for the 'C Compiler 
libraries. A good explanation of device drivers and descriptors, A Ba5ic39 sourcebook for advanced users. A 
beginners introduction to the operating system* with special reference to basic system setup and customization. 

The above list is by no means exhaustive* but represents at least a start. We would appreciate some feedback on 
the type of thing that you would like. We* at this end of the Newsletter are not magicians* but we think that at 
least some of the above list are possible* even from our own limited talents. 

As I said before* we need to know what you want. We also would like to invite criticism of the Newsletter. Are we 
producing the kind of material that you like? Do you want more Ba5ic09? More 'C programmes. How about some 
assistance with the Microware Assembler? The linker* and it's associated libraries? Would you be prepared to type 
in Motorola S-Code listings for already assembled programmes? How would you feel if we published the source code 
for some of the more popular Public Domain programmes? We need your feedback! 

What about users or potential users of OS9/68600? Should we produce triore material for those readers? Do we have 
any readers who are interested in OS9/680fl0 either currently* or in the future? Do you feel the need for further 
articles of the tutorial type similar to Don Berrie's series on the Macro Text Editor? How do you feel about 
source code spread out over several issues? Bob Devries' database in 'C is an example. Would you prefer to have 
the whole source in one lump? 

This of course illustrates one of our problems. Some of the source codes for more useful applications run to 
fairly large number of pages. The 'C Database series again serves as an example. A complete issue could have 
been devoted to Just that programme* however if you had no interest in that particular programme* then that 
particular issue would be wasted as far as your interests are concerned. 

Another problem is that while some of our contributors may be only too willing to share the compiled versions of 
their creations* they may not want the source distributed. This often means that the only way that those 
programmes could be made available is through our public domain disks. Let us know how you feel about getting some 
material that way. Remember however, that method would involve more expense. 
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This ftonth we again present our usual potpourri of listings and suchlike. We have the very last installaent of Bob 
Devries' 'C Database, A monuBental effort. I wouW like to take this opportunity to thank Bob for sharing this 
code with us. He also have another in the tutorial series on the 0S9 Macro Text Editor, front Don Berrie. 

Once again, I reftind you that we need froifi you some kind of feedback. Whether it's connnents, criticisffis, source 
naterial or questions, it*s important to us. Until next edition. 

Keep coaputing, Regards, Gordon. 

OOOOODOODOOOOOOOOOOOOOOODOOOOO 

EDIT : (Part 3) Using Macros 

One of the least used facilities of the built-in line editor is it's ability to use Macros. 

What is a rriacro anyway? Siaply put, a aacro is a series of coirmiands that an application can process. Of course, 
aost prograflBBes which have this ability, also have the potential for recursion, sultiple-step loops and conditional 
processing. If this sounds to you like a prograaiaing language, then you are correct. That is exactly what it is. 
Siiply put, Mcros are the ability to process instructions froa a device or part of »eftory other than an 
interactive keyboard. 

The 0S9 text editor supports the use of this kind of processing. Macros can be used to replace frequently used 
series of keystrokes, as well as more coffiplex recursive operations. Macros consist of two parts, the header and 
the body, and are called by the editor by the use of a full stop in coluirm one, followed by the nante of a 
previously defined inacro. For example : 

.inacro.naifte 

would call the aacro previously defined as "macro.name'. 

The header of the macro defines it's name, as well as any parameters passed to it. Sound familiar? (Alnost the 
sante as a Basic09 process! I) The body consists of any number of ordinary edit commands. 

The first part of the ffiacro header is the name. The name consists of any number of consecutive letters and 
uncterline characters. Even though macro na»es can be as long as you like, it would seem to me that short names are 
best. There seems to be no point in typing a twenty letter macro name, when the macro itself might only contain ten 
or twelve keystrokes. The aim is, of course, to reduce the operator input. Suitable macro names might be : 

uplo del.all dl ... 

One thing that the manual doesn't tell you is that there are a number of built in macros. For example "dir eof 
zero ... ect', in fact any of the 'dot' commands that we have previously dealt with. So you can't define a macro 
using one of those names. Unfortunately, the prograsme doesn't tell you this, but simply reports "Macro Already 
Defined" when you try to exit from the Edit Macros section of the progranrfne. 

The second part of the header is the parameter section. Like other edit commands, macros can accept parameters so 
that they can work with different strings and with different nuiijbers of items. Macros are unable to use parameters 
directly, that is from within the macro itself. Instead, Edit passes the parameters on to the coiwfiands that make 
up the lacro. 

As with a Basic09 procedure, when passing paraaeters to a macro, it is important that the macro knows how many 
parawters there are, what order they are in, and what type they are (whether numeric or string). This information 
needs to be defined in the second part of the macro header, commonly called the macro variable list. 

Each variable in the macro variable list represents the value of the macro parameter in its corresponding position. 
There are two acceptable types of macro variables (parameters). These are numeric and string variables. A 
variable can be defined using any name (with similar restrictions to those of macro nai&es) preceded by a 'I' or 
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'%\ Variables starting «ith a '#' character are interpreted as nuieric variables, while those starting with a '$' 
are interpreted as strings. Suitable variable names aight be : 

#N #LONG iiteration.nufflber #abc ... for numeric variables, 

and *A $str $STR_A ... for strings. 

So the first line in a macro could be : 

DLL #TI^ES tsearch.string, 

where DLL is the macro name, and #TIMES and $5earch_string are numeric and string variables respectively. 

The body of the macro would then continue. Any edit commands could be used in the body, as well as special macro 
commands. The special macro commands are : 

.MAC<delim>STR<delim> ... STR means any string, for a previously defined macro, within the confines of a pair of 
similar delimiters. This command opens an existing macro of that name, 

.MAC<delim><delim> ., creates a new macro. 

Both of the above commands put the editor in the macro editing mode, and the screen shows M: instead of E: to show 
that the editor is indeed in that mode. 

! - Exclamation point. This character is used to place comments inside a macro definition. Any characters between 
an exclamation point and the next <CR> are assumed to be a comment, and are not processed. This means that you 
could use a command at the beginning of the line, and then follow it fay a comment, on the same line, 

Q <CR> - Quits the edit macro made and returns you to the edit mode. The first line of the macro MUST begin with a 
name that is not already previously defined, in order to close the definition and return to the Edit mode. 

.string - Full Stop followed by a string. This is interpreted as a command to execute another macro. Essentially, 
this is the mechanism for allowing recursion of macros, however you should be very careful when using recursion 
inside a macro. It's very easy to get yourself into a loop which has no way out! 

There are a number of other commands that, while they may be used within a macro, are more properly used for the 
loading and saving of your macros for future use. Some of these commands are : 

.SAVE<deliB>STRl<delia>STR2<deliffi> - This command saves STRl, which may be a single macro name, or a list of macro 
names delimited by spaces, into the file with a pathnaw of STR2. The command tries to create this file, and will 
report an error if it already exists. A bit stupid if you want my opinion. 

,LOAD<delim>STR<delim> - This command is used to load a macro file previously saved by the .SAVE command. If 
during the load, an attempt is made to load from the file, a macro with the same name as one already defined, then 
this macro is skipped, and the load proceeds from the next macro name. 

.DEL<delim>STR<delim> - This command is used to delete a macro named STR in the macro buffer, 

.SEARCH and .CHANGE - These commands perform similar functions to their equivalent Edit commands. 

The actual process of writing a macro is reasonably simple, especially when the task that it is to perform is 
simple. Quite complex macros can be built up to perform tasks that would normally require large numbers of 
keystrokes. I hope to be able to present some macros that you can use with Edit in future issues of the 
newsletter. 

One of the things that I find infuriating with this editor, is the fact that when you use the 'D' command, the damn 
thing echoes the deleted line, not the current line. The following is a macro that deletes n lines, lists the 
lines that are deleted, and then lists the current line. To use it, simply type : 
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.dl n 

wher-p n is the nuirtber of lines to delete. 1 hope i-jou like it. Perhaps this will spur you onto bigger and brighter 
things. You never knoui, you might even want to sharp your creations with the rest of us. Another helpful exercise 
to do to aid you in the developiTient of inacros is to do Sample Session 5, on Page 7-49 of the OS? Level Two Users 
Manual iP?.qB 55 of the ORANGE Level One Manual). 

Good Luck with your macrosT Don Berrie. 

<Li sting) 

dl ttM 



V0 

[ 

D 

] ifN 

VI 

L 



The above line is then hacro Header 

Turn verify off 

Beginning of loop 

Delete a line 

End of loop and loop counter 

Turn verify bach on 

List Current line 



<End of Listing!: 



nooOOOOOOoOOOO'JOOOOOODOGDOODDO 

The OS? ^C* Coffipiler. 
A review by Bob Devries. 

The C compiler programnie I have used to cnrnpile it-m prograFiiTies for Colour Computer 0S9 has been the one sold 
by Tandy. Its catalogue number is 26-3038i and it is sourced from Microl-lare Systems, 

The C compiler comes on 2 35 track, single sided, hM sector Colour Computer OS? disks as is normal with 
all Tandy 0S9 products. The package also includes a user manual. 

The two disks contain all the necessary programmes and data files to enable you to compile a programme from 
C source code to an OS? 6813? code object module. On the main disk, which is MOT bootable, there is only a CMDS 
directory which con tains :- 

CCl C.PREP C.PASSl C.PASS2 COPT C.ASM CLINK 
COPY DEL DIR ECfiO LIST 

The second disk contains three directories in the root directory, 

LIB DEFS SOURCES 

The LIB directory contains the standard library clib.l and the start code cstart.r. Both of these are 
required for compiling programmes. 

The DEFS directory contains a number of header files which contain C definitions and other useful 
information. 

The SOURCES directory contains sample source code files, and another directory called SYS which contains 
some assembler source code files. 

Having told you what's on the disks, Til now tell you a bit about the programmes themselves. The compiler 
consists of several programmes which are used together, along with a small programme which interprets the command 
line arguments, and builds a script file to do the actual work. 

The first programme used is the pre-processor. Called C.PREP, this programme looks through the source code 
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and expands niacroS) adds the include files, and sets up any definitions required. 

The next part is the cotitpiler pass one, called C.PASSl. This prograiiinie checks the synta>; and structure of 
the source code. 

C.PASS2 coniES ne>;ti and it does the actual changing of the C source code into assefiibler source code, 
setting up reserved iriGiriory requireuients, setting up the strings for the asse.Tibler etc. so that the assefttbier can 
correctly assemble the code. 

COPT is a code optiniiser uhich removes any unnecessary cede and coiiifijents (if any), changes long branches 
to short branches where it can, and generally tightens up the code. 

C.ASM is really a disguised (early) version of the Relocatable Hacro AsseiJ/bler such as the one found on the 
'DevelopiTient Systeni' disk. This section converts the assenibler source code into object code, but leaves spaces fut- 
the addresses of all the subroutine calls to the standard library and other e-iternal niodules such as 'cstart.r'. 

The linker, CLINK, noiu comes along and joins together all of the sections of code. It places 'cstart.r' at 
the beginning, then the body of the ccnipiled prograniiiie, and then checks through the code and adds any library calls 
to the end of the module. Finally it outputs an 0S9 runnable tS09 code prograiiidie module. 

All these operations are, hoiiiever, coiiipletely autoiTiatic, and the user has fiierely to call the compiler uith 
the conifliand line:- 

CCl myfile.c 

This uill result, if there are no errors, in a file called 'lyfile' to be placed in the execution 
directory, along with the C compiler progr affiles - 

There are a nuniber of options available, such as a '-f=' option uhich will tell the linker to place the 
final iiiodule in whatever path is typed after the option. 

e.g. CCi (Tiyfile.c -f^/rS/myfile 

So you can see that this compiler is easy to use, and, if you know how to write nice tidy C source code, 
you will end up with prograMes that work well and are not unreasonably long. The compiler is suitable for both 
Level One and Level Two 039. 

When I compare this C co^ipiler with others I have used, I do notice that it is nc-where near as fussy about 

syntax as, say, the Lattice C compiler for the Amiga. Dith the Microyare cofiipiler, for etiample, a pointer to a 

structure may be replaced with the name of the first element of that structure, something which is a definite no-no 
in Lattice C 

There are some other little peculiarities. For e>;aniple, most C compilers require a cast to be used for the 
^sizeof function when using a structure, like thisi- 

size = si zeof (struct struct_name); 

The MicroWare compiler, however, really mucks things up if you do it that way, and only allows the 
structure name, like thisi- 

sire = 5izeof(struct_name); 

Once you get to know these little funnies, this compiler works well, and outputs the expected code, tihen 
you combine this with a number of enhancements in the form of patches to several of the modules, especially the 
replacement of the 'CC\' with a (C) programme in the public domain library called 'CC which makes available 
several other options not normally available, the liicrolJare compiler is really worth having. 

The MicroWare compiler is the only compiler really produced for Colour Computer 0S9, and is certainly 
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streets ahead in the inatter of price. The next available coTipiler is the tiicrDWare Level Two cofiipiler for over 
$3P0. At the normal retail price of 1179.95, this fnakes the Colour Corriputer version look very healthy^ especially 
if you can pick it up for the very fiiuch discounted prices I have seen lately. 

yhen you add the extra libraries and header files froiTi both the 'Development System' disk and the public 
domain library, the C compiler really is utorth having. Once you have friastered the C language, an art in itself, you 
can Dirite all sorts of programmes, both small and large, and have them running in no time at all, and, because the 
result is frtachine code, they run fast. Seeing your om programmes running really gives you a boost, and makes it a 
pleasure to write more. 

Regards, 
Bob Devries, 



oDDDOooonoun'junuf.innnDnoooooooo 
A Database in C 
By Bob Devries 

At last me have come to the last installment of my database programme. Whew I That was some marathon 
effort. Those of you iL'ho went to sleep half may through can wake up nom, while I think of something else to write. 
Ho'iipver, before that, I'll have to give you the last part of the programme, and the directions on how to compile it 
using the liicroWare C compiler. 

First off, type up the last three sections of the code, and check that they are correct. Now, to compile 
the programme, you'll need to have all of the previous sections in the same directory together. I usually use my 
ramdisk for this, it makes the compiler run a bit faster, and doesn't mess up a disk with the temporary files the C 
compiler creates. 

Now, make sure your C compiler disk(s) are in their correct drives, and that your execution directory is 
pointed to the C compiler CMD3 directory, and the working directory to the directory that has the database files on 
it. The command to compile is simply this:- 

^ CCl db.c 

For those of you who are using the modified version, or the programme 'CC from the public domain library, 
you may replace 'CCT with either 'CC or 'CC2' or whatever you use. This syntax will place the compiled programme 
into the CMDS directory of your C compiler disk. If you would prefer not to do this, then use the following command 
line:- 

CCl db.c -f=/R0/database 

This will place the programme in the ramdisk. You may change 'Rfl' to any other drive or directory. 
Remember, you must give the complete path. 

Now a quick word about the last parts of the programme. The 'amend' function allows the user to change the 
contents of the currently selected record. This function then calls the save routine to commit the new record to 
disk. The 'match' function allows the user to find more records with the same name, after the first 'find'. It will 
continue searching through the database file to see if there are any more records with the same 'Surname'. The last 
segment of code, 'db.c' is merely a list of ■ include' statements to tell the compiler which files to use when 
cnrifpiling. Don't forget that the file 'ansi.h' must be present also. Well, that's about it for this series, as 
usual, I'm available to answer questions if there are any, but remember, I will not be able to make any major 
revisions to the code, 

ampnd(rpcno) 

int i^ecno; 

/* amendO replaces each field with a neiit entry e;;rppt where ENTER is */ 

/* pressed alone (giving a null string) when it will leave the original ^/ 

/* field data intact */ 
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char ch; 

char tefTip5tr[20]; /* teffiparDry string for inputting new data */ 

int tenipcodel /* teniporary int var for postcouie */ 

int replace; /* flag for signalling replace curr record */ 

ch = '\0'; 

while (TRUE) /* do forever */ 

( 

cursordAiS); 

get£(teffiP5tr); /* get u&er input t/ 
if {teffiP5tr[0] != '\0M /* if not a nullE-tring */ 

5trncpy(mail.5urna(TieitetTip5tr»20}; /* keep the string */ 
cursor (51 i5)t /*■ and keep going */ 

get5(teii(P5tr}t 
if (teiiiP5tr[0] != '\0'} 

5trncpy(ii(ail,fir5tna;i(eite(ripstrt20); 
cur5or(13t7)i 
get5(teiiip&tr); 
if (tenipstrCfl] != '\9M 

st r ncpy ( ilia il. street tteiTipstrt 20); 
cursor(lli8); 
getsitempstr); 
if (teii,p5trC0] i= '\0') 

&trncpy(iiiail.cityttEfiipstrt20); 
cursor{12iV); 
get5(teniP5tr); 
if (ten.p5tr[0] != '\0') 

strncpy((i(ail,5tateiteffip5tri3) ; 
cursordSilO); 

tempcDde = atDi{gets{tEffjpstr)); 
if (tempstrCOl != '\0') 

iTiail. post code = tetiipcode; 
cursor (101 23); 
eraselinO; 
cursor (101 23); 

printfCAll correct ? y or n "); /* print proiiipt */ 

while ((ch != 'NM hh (ch != ^Y^)) 

ch = tDupper(qetchi)); /* user ffiust press y or n */ 

cursor (10) 23); 

eraselinO; /* erase message line */ 

if (ch == 'V) /* if user typed 'y' then e>iit loop */ 

break; /# else loop round again */ 

i 
recno = save (recnoi replace); /* save the changed record */ 



iiiatch(recno) 

int recnoi 

/# BiatchO searches froiii the current record for niore iriatches of the surnanie */ 

/* given in the first findO it either displays the wanted record or */ 

/* re-displayes the record it started from. siatchO returns the neiii (or old)*/ 

/* record number */ 

{ 
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int teffiprec; 
char teiripnaiTte[21]; 
long iof,po5; 
char ch; 

teiiiprec = recno; 

St rcpyttempnameTiTiail. surname )i /* keep currerit surname field */ 

pos = ftell(fp); 

if (pos — la5trec#sizeof (iTiaiD) 
{ 

cursor (10, 23) ; 
printfCNo ffjore records.'); 
return (teiTiprec); 

do 

{ 

pos = ftell(fp); /* keep reading records until EOF */ 
fread(kiailisizeof (irtaiDTltfp); 
if (pos == lastrec*sizeDf(!iiail)) 
{ 

cursor (10,23); 
printfCNo iriore found.'); 
return (terriprec); 
} 
} while (5trcmp(n(ail.5urnanieTterrtpnaii»e) != 0); /* or the match is found */' 
recno = ftelKfpJ/sizeof (mail); 
return (recno); /* tell the calling routine the record number */ 



/* database include file. */ 

/* use this for the coffipiler command line argusent */ 

#include 'database. c' 

#include 'scrninask.c' 

^include 'delete. c' 

^include 'save.c' 

tlinclude 'help.c' 

#include 'find.c' 

^include ' insert. c" 

tinclude 'usage. c' 

#include 'iriatch.c' 

#include "airtend.c' 

tinclude 'scrndata.c' 

/* The end */ 



COCO-LIM< Hagazine: Just a reminder for those interested in a wider section of CoCo systems. CoCo-Link is 
produced in South Australia and is well morth your support. Contact the Editor » Robbie Dalzell on (88) 386 1647 or 
write; 

CoCo-Link 31 Nedland Cres. PT. NOARLUNGA SOUTH S.A. 5167 

The bi-monthly magazine uiiil cost $8.00 joining fee plus $12.00 subscription annually. 
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mi HAPPENS TO THE SYSTE M ARER HY PROGR AM RUNS? 

f?ecently, «e rave seen a ruTiDer of programfr,es, t)o;h ComfTiercia'^ and PubiiC Dorriair>, wnicfi do a number of 'funny' 
thnqs to ycur S/SteTi. Scins of the ones that cofr,s to minQ are DMTREE/HOf^rEE and t^'IfJOOK »<fRITER (CopyrTght.) and 
fc^A/IC fPuDiic DoTaini. The following article is presented after a weekend of (so far net totally successful iv) 
iry'oq to restore 'tiy syste.i to its normal state after running 'pdndow l^Titer. I fully realise thai: when one 
aiterripts to »*r-:e a orccran: which will successfully run in a i26K iriachine, then you are severely limited as 
to what you can realty Co. rowever, sL;rely "t's possible to restore the palette register information to what 
it was? How about giv^nc me back the keyboard attributes ... so that at 'eas: the (BREAK) key works, or 
(CTRD-W for screen pausing^ 

I don't particularly ^^ant to pick on Window Writer. I think that it is a fine program, and certainly offers 
more features that any other Color Computer word processor that I have seen. But, after I run it, it leaves 
my system in suci a ness, that I have no choice but to press the 'BLACK BUTTON' and reset the dar^n ining. 

I oon't think tiat is good enougn. 

Let me start at the beginning. A friend of mine phoned me, and asked .Tie to have a lock at his machine, as he 
thought that there was a problem. After travelling to his place, and scrutinising his computer, I found that 
something strange had indeed happened to it. Upon closer examination, we decided that his problein occurred 
only after running his new wordprocessing prosranime, Window Writer. 

So what were the symptoms? Well, the most obvious thing was the screen. Light blue characters on a violet 
background. Odd! Then there was the fact that the (BREAK) key did not work. He normally runs his screen with 
the page pause set. but all his text files, when listed, scrolled merrily off the screen. Then there was the 
memory problein. Suddenly, only very little available RAK. And guess what? 'Mdir e' showed the module 
directory with heaps of modules that he knew nothing about, and with link counts varying from to many. 

He loaned me his original disKs, and the manuals, to take home to find out what he nad done wrong. The simple 
answer was, nothing!! That unfortunately is how the programme leaves the system. I cannot accept that a 
serious commercial programmer could be that sloppy. But there it is, Not only that, but the programme 
actually needs to merge a couple of modules with the Basic09 interpreter module, RUNS. If, like most people, 
you have merged the Syscall, Inkey and Gfx2 modules with RunD, the you will not be able to get the programme 
to run a: aU. 

(When the other modules were added to the ones that I already hac ^ergeo with Runb, the whole thing was greater 
than three 6k blocks. This aoes not leave enough room within a 64k logical space to run the programine.) 

I then tried a number of ways to try to get around the problem, out as yet, I have net successfully found a 
way to rectify it. The alterations to the screen and keyboard attributes can be simply overcome (on a 512K 
system) oy opening a device window and running the programme in that, When the programme terminates, simply 
close tne new window, ano an the modified attributes die with it. 

Jh^ orcbleTcf f^e modules ^n mefnory is not so simple. If ycu are familiar with the p.^'ogramme, you will have 
rioiKeo that the text fo.'-iriatter (for ouiputting text to a printer) runs as a separate process. I think tnat 
the fcrmatLer is chained from the original programme, When :hat part is finished, i: chains back to the 
cnQinal poogramme!!! (When a orogramme is chained in 058, "t k/ilis the calling process.) Ycu can see that 

things start to get corcncated. 

With regrets and apologies, I returned the originals to my fr-e^z, a^ter destroying, :f course the copy that 
I hac fi^ace. It rzz]]j uqb me fee^ trankful thai I use Siylcc'-apr! Seriously though, D/ the time tne next 
issue 0^ tne News'etter is onntea, I hoce to be able tc irc^jQS a 'system clean-uc^ Ba3ic09 programme i:i2K 
use^s cnlv, ji^ctunsteiv i fcr Wmcow irr]ter, to do tne work tnat the cngina; prog''ammer failed to cc. 

'uri'-er in^ormat'on .c^ can coiiact ^e en iOm 3T5-3235. Cheers ... Don Berne. 
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